home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / macros / latex / packages / graphics / 00readme.txt < prev    next >
Text File  |  1994-12-18  |  6KB  |  189 lines
  1. %%
  2. %% This file is part of the Standard LaTeX `Graphics Bundle'.
  3. %%
  4. %% It should be distributed *unchanged* and together with all other
  5. %% files in the graphics bundle. The file 00readme.txt contains a list
  6. %% of all of these files.
  7. %%
  8. %% A modified version of this file may be distributed, but it should
  9. %% be distributed with a *different* name. Changed files must be
  10. %% distributed *together with a complete and unchanged* distribution
  11. %% of these files.
  12. %%
  13.  
  14.  
  15. The LaTeX Colour and Graphics Packages
  16. ========================================
  17.                     1994/11/29
  18.  
  19. This is a pre-release of LaTeX packages for:
  20.  * producing colour
  21.  * including graphics (eg PostScript) files 
  22.  * rotation and scaling of text
  23. in LaTeX documents.
  24.  
  25.  
  26. This is still a test release.
  27.  
  28. Main Changes in the November/December 1994 version
  29. ========================================================================
  30.  
  31. color.sty
  32. ============
  33.  
  34.    Some code now obsolete code removed as the new LaTeX kernel is more
  35.    colour-aware.
  36.  
  37. graphics.sty
  38. ============
  39. **** Important Note: Change in user-syntax!
  40. *******************************************
  41.     The optional argument to     \DeclareGraphicsExtensions 
  42.     has been removed.
  43.     The new behaviour is equivalent to specifying an argument of []
  44.     in the previous version. ie there is *no longer* a default `.'
  45.     added.
  46.  
  47.     As a consequence of this, all extensions must now be specified
  48.     including the `.' ie .eps not just eps.
  49.  
  50.     This change does not lose any functionality, and makes it much
  51.     easier to work with files with no extension.
  52.  
  53. David Carlisle 1994/11/29
  54.  
  55.  
  56. ========================================================================
  57.  
  58.  
  59. THIS DIRECTORY CONTAINS 
  60. ======================
  61. ======================
  62.  
  63. 00readme.txt    This File
  64. changes.txt     Log of changes to the packages.
  65. graphics.ins    Install file for docstrip.
  66.  
  67. Standard packages
  68. =================
  69. color.dtx       Source for color package
  70. graphics.dtx    Source for graphics package
  71. trig.dtx        Source for trig package (required by graphics)
  72.  
  73. Non Standard Packages
  74. =====================
  75. graphicx.dtx    Source for graphicx package (extension of graphics)
  76. epsfig.dtx      Source for epsfig package (extension of graphicx)
  77. keyval.dtx      Source for keyval pacakge (required by both the above)
  78. pstcol.sty      Small wrapper for pstricks package.
  79. lscape.sty      Produce landscape pages in a (mainly) portrait document.
  80.  
  81. Driver Files
  82. ============
  83. drivers.dtx     Source for driver files for supported drivers.
  84.  
  85. User Documentation
  86. ==================
  87. grfguide.tex    User Guide to all the packages in this bundle.
  88.                 WARNING: 
  89.                 This file calls color and graphics packages
  90.                 without a driver option. 
  91.                 You *must* set up two files 
  92.                                  color.cfg and graphics.cfg
  93.                 containing (for example)
  94.                                 \ExecuteOptions{dvips}
  95.                 Before running this file.
  96.  
  97. grfguide.ps     PostScript version of the above (Using PostScript fonts)
  98.                 You may use this to see examples that your driver may
  99.         not be able to achieve.
  100.  
  101.  
  102. =============================================
  103.  
  104. TO UNPACK THE PACKAGES
  105. ======================
  106.  
  107. latex graphics.ins
  108.  
  109. This will produce the 
  110.  
  111. .sty package files
  112. .def driver files.
  113.  
  114. =============================================
  115.  
  116. USING THE PACKAGES
  117. ==================
  118.  
  119. Move files ending in .sty .def  to a standard TeX input directory.
  120.  
  121. Make a default option for your site by creating two files
  122.      color.cfg and graphics.cfg
  123. containing (if dvips is your default driver)
  124. \ExecuteOptions{dvips}
  125.  
  126. You may then LaTeX the user guide:
  127. latex grfguide.tex.
  128.  
  129. ==============================================
  130.  
  131.  
  132. Comments from the previous release.
  133. **********************************
  134.  
  135. Main Changes in the July/September/October 1994 version
  136. ========================================================================
  137.  
  138. color.sty
  139. ============
  140.  
  141. 1) I separated out the code that converts from `user syntax' to the
  142.    internal version for \special from the code that actually inserts the
  143.    special.
  144.    This means that:
  145.    * It should be easier to work with PSTricks, where the `internal' code
  146.      has to be done *inside* a larger special, so you can not do any
  147.      fancy TeX stuff at that point. A pstcol.sty using pstrics with 
  148.      color.sty based colours is included in this test release.
  149.  
  150.    * The .def file can be a lot simpler as it no longer has to define a
  151.      a `set' command and a `define' command for each colour model.
  152.      It just defines a single `user spec' to `special syntax' command
  153.      for each model, \color and \definecolor both use this same
  154.      internal interface.
  155.  
  156. 2) \color \textcolor are now robust.
  157.    [although \textcolor turns into \color if used as a robust command.
  158.     That is if you say \textcolor{red}{foo} in a section header, 
  159.     the toc file will have {\color{red}foo}
  160.    ]
  161.  
  162. 3) \textcolor is no longer \long (so it matches \textrm) if you want
  163.    lots of paragraphs use \color or \begin{color}
  164.  
  165. 4) Added \DefineNamedColor command to give an interface for the 'named'
  166.    colour model.
  167.  
  168.  
  169. graphics.sty
  170. ===============
  171.  
  172. 1) Added a default rule, eg dvips.def now has the equivalent of
  173.    \DeclareGraphicsRule{*}{eps}{*}{}
  174.    Which means that you can include file with arbitrary extensions:
  175.    \includegraphics{a.xyz} 
  176.    will input this as an eps file unless another rule has been decared
  177.    for the extension xyz.
  178.  
  179. 2) More care taken with catcodes so hopefully this version will work
  180.    with language packages that make ! or " active.
  181.  
  182. 3) Add new error
  183.       {Cannot determine size of graphic in ... (no size specifed)}%
  184.    Generated in the case that the file type has no `read file'
  185.    specified, but the user has not given a size argument.
  186.  
  187. 4) New driver loading code.
  188.  
  189.